			GBColorizer
			Version 2.4
		     Released 12/01/02

Contents
---------

1.) What is GBColorizer?
2.) What's new
3.) How to use GBColorizer
    a.) Loading/Saving
    b.) Palettes
    c.) Tile Browser
    d.) Tile Editor
4.) Troubleshooting
5.) Credits/Contact
6.) Disclaimer

1.) What is GBColorizer?
-------------------------
	GBColorizer is a windows utility that converts non-
color Gameboy ROMs into Color Gameboy ROM. To do this it
allows you to set up to 16 4-color palettes and assign them
to each graphic tile in the game. GBColorizer can them write
a new copy of the ROM in Color Gameboy format using all the
color information you created.
	This program is still in the early stages of
development. It's compatability is still quite low (see
Loading/Saving). Hopefully I will release improvements in the
near future, so keep an eye out.

2.) What's New?
----------------
	Version 2.4 is a very minor update. I'm only releaseing
it because I haven't finished the code for MBC2 and 3 yet. Time
allowing, I plan to have that done very soon.

	-Made the Background Refresh Rate adjustable. Lowering
	 this when writing the ROM may help some games that
	 buged out when played
	-Optimized tile refresh rate with some API's and other
	 tricks. Now works faster (but not perfect)
	-Optimized ROM scanning function - now works a little
	 faster
	-Added some cursors ;)

3.) How to Use GBColorizer
---------------------------
    a.) Loading/Saving -
	You can load a game into GBColorizer by selecting
	'Load ROM' in the 'File' menu. GBColorizer's
	compatability is still wuite low. All games must:
		-be a non-color compatable game
		-use MBC1 (MBC2 and MBC3 support soon)
		-be 512k or less

	You can Load/Save all the palettes and their assigned
	tiles as well as any edited tiles by selecting either
	'Load GBP' or 'SaveGBP' on the 'File' menu.

	When you are ready to create a Color Gameboy ROM
	select 'Write ROM' from the 'File' menu and select
	a Background Refresh Rate. Click 'Okay'. Setting this
	lower will help ROM's that bug out, but may cause
	palette flickering in the background tiles.

    b.) Palettes -
	You can change a color in a palette by clicking right
	on it. Then just move the Red, Green, and Blue scroll-
	bars to change the color. When done click 'Okay'.

	You can switch between Sprite and Background palettes
	using the option boxes in the lower right corner of
	the window.

    c.) Tile Browser -
	A Gameboy ROM is divided into 16kB banks. The number
	of banks a ROM has depends on the size of the ROM.
	You can switch what bank you are viewing tiles from
	using the scrollbar at the bottom labeled 'Bank'.

	Each bank is split up into 4 pages. You can switch
	pages using the scrollbar labeled 'Page'

	If the tiles in a ROM are not placed evenly in a bank
	they will look distorted. Adjust the 'Tile Offset'
	scrollbar to fix this.

	To change what pallette a tile uses, select the tile
	by clicking on it. Then click the option box next to
	the associated palette.

	You can select multiple tiles at once by holding the
	mouse button down and dragging the selection box over
	the tiles you want to change.

	Pixel Switch - See Tile Editor

    d.) Tile Editor -
	Double Click any tile in the Tile Browser to open the
	Tile Editor. Select colors for the left and right
	mouse buttons by clicking on the colors on the right
	side of the window. Click in the Tile Editor to apply
	pixels of those colors.

	Pixel Switch - This option allows you to switch all
	the pixels of the left button color with all the pixels
	of the right button color. This is handy for making
	the most use of your palettes. This option is also
	available in the Tile Browser so you may perform a
	single Pixel Switch on many tiles at once.

3.) Troubleshooting
--------------------
Problem: You get the error 'Not enough room for color code:
	 must overwrite ROM code. ROM may not function
	 correctly when colorized!'
Fix:	 Sorry. There's no fix here. GBColorizer requires a
	 certain amount of free space in Bank 0 to implement
	 color code. If it can't find that space it will
	 overwrite existing code which will probably make the
	 colorized ROM not work.

Problem: I see something that looks kind of like the tiles
	 but they look all distorted!
Fix:	 Adjust the tile offset untill they look correct.

Problem: My ROM works but, bugs out!
Fix:	 Try lowering the Background Refresh Rate. If that 
	 doesn't work I don't know what to tell you.

Problem: My ROM doesn't work at all when I colorize it!
Fix:	 GBColorizer is still in it's early stages of
	 development so it may have many compatability issues.
	 I hope to fix many of them in the future.

4.) Credits/Contact
	Thanx goes out to EmuJerky for advice on API's as well
	as all the contributer's of the Pan Docs for the most
	complete guide to the gameboy ever.

	GBColorizer as well as the Z80 color code were both
	written by MistrFishy

	If you have any comments or questions you can email
	me at blind_tom@hotmail.com

	*DO NOT email me asking for ROMs OR attempt to send me
	a ROM. I will block your email address.

5.) Disclaimer

GameBoy and Color Gameboy are copyrighted by Nintendo Co., LTD.
GBColorizer as well as any reference to copyrighted material are
not for monetary gain, but for educational purposes.
